home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / usersec.zip / USERSEC.DOC next >
Text File  |  1991-09-29  |  4KB  |  94 lines

  1.                                 USERSEC v1.01
  2.  
  3.           Copyright 1991 by Jay Caplan. All rights reserved worldwide.
  4.  
  5.  
  6. This batch file utility for PCBoard v14.x and compatible systems will return
  7. the security level of an online user as a DOS errorlevel. The program is
  8. network aware, and opens all files in SHARE mode.
  9.  
  10. This utility was written to fulfill a need I had on my board where I wanted
  11. a batch file to perform different actions based on the security level of a
  12. user online. Since PCBoard v14.5x doesn't have real-time upload/download ratio
  13. enforcement, I am using Geoffrey Sy's PCBFRE program in a batch file that's
  14. used as a user logs on. However, I only want it run for regular users, not
  15. everyone. I use this utility to bypass running PCBFRE if the user's security
  16. level is higher than a regular user.
  17.  
  18.  
  19. Using the program:
  20.  
  21. 1) Copy USERSEC.EXE to the PCB home directory, like C:\PCB, or a directory on
  22. the DOS PATH.
  23.  
  24. 2) Call this program in a batch file used by your board, and test for the DOS
  25. errorlevel returned. Remember to test for the HIGHEST errorlevels FIRST.
  26.  
  27. 3) PCBOARD.SYS must be in the default directory when the program is run.
  28.  
  29. 4) The program accepts one OPTIONAL parameter. You may specify the fully
  30. qualified path/filename to the USERS file.
  31.  
  32. Example: "USERSEC C:\PCB\MAIN\USERS"
  33.  
  34. If you specify the location of the USERS file, then the program will operate
  35. faster, because it doesn't have to go looking for this file. If you don't,
  36. then it will open the PCBOARD.DAT file to find out where USERS file is.
  37.  
  38.  
  39. If the program experiences any errors, it will return with a DOS errorlevel
  40. of 1. Possible error messages are:
  41.  
  42. a) "PCBOARD.SYS not found in default directory, aborting."
  43.  
  44. b) " 'user-specified USERS file' not found. Will try using PCBOARD.DAT to
  45. locate USERS file." The actual name you gave will be quoted above.
  46.  
  47. c) "PCBOARD.DAT not found in default directory, aborting."
  48.  
  49. d) "Unable to access PCBOARD.DAT, aborting." This is possible if used in a
  50. network/multitasking situation and another process has the file opened in a
  51. mode that denies read access. This is unlikely, unless you use other PCBoard
  52. utilities that access PCBOARD.DAT and are network dumb.
  53.  
  54. e) "Unable to access PCBOARD.SYS, aborting." See reasons above. No other
  55. process should be accessing this node's PCBOARD.SYS, so this is a very
  56. unlikely error.
  57.  
  58. f) "Unable to access USERS file, aborting." This is possible in
  59. network/multitasking situations, if another process has the USERS file opened
  60. in a mode that denies read access. This should NOT happen. Any network aware
  61. program that accesses the USERS file while the board is up should only do
  62. record locking at most, not file locking, which could generate this error. And
  63. no other process should be locking the user's record for this node. So, I
  64. consider this an unlikely error.
  65.  
  66.  
  67. Terms of use and disclaimer:
  68.  
  69. This program (USERSEC.EXE) is Copyrighted 1991 by Jay Caplan. All rights
  70. reserved worldwide. You are given permission to freely use, copy, and
  71. distribute this program, under the following conditions: you do NOT charge
  72. any money for copying or distributing it, you do NOT include ANY other
  73. files within the distribution archive (including any BBS ad files), that
  74. you always keep the program and documentation (USERSEC.EXE and
  75. USERSEC.DOC) together whenever you distribute it, and that you do NOT in
  76. ANY way modify the program or its documentation file.
  77.  
  78. This program is being made available on an "AS IS" basis. You use this program
  79. AT YOUR OWN RISK. You assume FULL and COMPLETE responsibility and liability for
  80. its use. I do NOT guarantee that it will work correctly for you. By running
  81. this program, you are agreeing to these terms.
  82.  
  83.  
  84. Contacting the author:
  85.  
  86. You may contact me (Jay Caplan) on my board, The Consultant BBS at 718-837-3236,
  87. or leave E-mail for me on Compuserve to user-ID # 70421,17.
  88.  
  89.  
  90. PCBoard is a registered trademark of Clark Development Company, Inc.
  91. Qmail is copyrighted by Sparkware, Inc.
  92. PCBFRE is copyrighted by Geoffrey Sy.
  93.  
  94.